Form Field IDs for Transaction Types

You can use the following form fields to design the gate transaction type forms for data entry at various gate stages.

Notes

 

Appointment Number

Displays a text field for the clerk to enter the appointment number.

When a clerk enters an existing appointment number, N4 automatically fills-in the form fields with the details saved in the appointment.

If a clerk enters an existing Appointment Number in the Pre-Selection area on the <GateStage> tab, this Appointment Number field is pre-populated with the appointment number.

 

Booking Accessory Type

Displays a lookup field of accessory types in a gate form.

For a Receive Export (RE) or Deliver Empty (DM) gate transaction the field is pre-populated with the accessory type specified on the equipment order (Booking, EDO) item when the clerk,

 

Booking Item

Displays a drop-down list of equipment order (Booking, EDO) items, specified for an equipment order, in a gate form.

N4 automatically fills in the equipment order items specified on an equipment order (Booking, EDO) when the clerk does one of the following:

For hazardous order items, the Booking Item field's list of values display the IMDG class and UN number. This enables you to select the appropriate order item when an order contains more than one hazardous order item.

If the Order Item Not Unique check box is selected for a line operator, N4 tries to match the order item, if possible. If multiple non-unique order items exist, N4 displays an error message and the user must select the appropriate order item. For more information on the Order Item Not Unique check box, see the Booking Rules tab.

For a Receive Export (RE) or Deliver Empty (DM) gate transaction, when a clerk selects the Booking Item, the existing equipment order item data will pre-populate in the following fields,

If these fields are also displayed on the gate form.

Notes

 

Booking Number

Displays a text field for the gate clerk to enter an order number (booking, EDO, ERO, or rail order) in the gate form. Unlike the Booking/Order lookup field, the Booking Number field does not display a list of values while the gate clerk enters the order number.

If you use the SelectExportContainer (on page 1) business task, XPS will select the best available dray-off export container in the yard based on the value entered in the Booking Number field.

If the Booking Number field does not display a list of values with the line operator

If a line operator allows duplicate booking numbers and multiple orders with the same number are present, the Booking Number field does not display a list of values with the line operator or Vessel Visit to help you identify the correct order. Therefore, Navis recommends that you add the Line ID field to the gate form before the Booking Number field.

However, if N4 finds duplicate booking numbers, such as an EDO and ERO for same line operator, then N4 displays the Duplicates Found - Please Select From The List form asking the clerk to select the correct booking. This form displays the Number, Sub Type, Facility, Line Op, and Ves. Visit fields for the duplicate bookings found.

Pre-populated fields

If the following fields are included in the gate form, the existing data is automatically filled in when a gate clerk enters an order number in the Booking Number field:

If a gate clerk enters a pre-advised container number, then N4 automatically fills in the Booking Number field with the pre-advised order number.

 

 

Booking/Order

Displays a lookup field of orders (booking, EDO, ERO, or rail order) in the gate form.

We recommend that you include the Line ID field before the Booking/Order lookup field in a gate form.

If you use the SelectExportContainer (on page 1) business task, XPS will select the best available dray-off export container in the yard based on the value entered in the Booking/Order field.

The Booking/Order lookup field displays the Line ID and the Vessel Visit in parenthesis after the order number to help you identify the correct order when multiple orders with the same number are present. For an EDO, the Booking/Order lookup field displays the Line ID and Facility name in parenthesis after the order number to help you identify the correct facility the EDO is created for. If the EDO is created at the Complex scope level, the list does not display facility name in the parenthesis.

Pre-populated fields

If the following fields are included in the gate form, the existing data is automatically filled in when a gate clerk selects a value from the Booking/Order lookup field:

If a clerk enters an existing booking number in the Release Number field in the Pre-Selection area on the <GateStage> tab, the Booking/Order field is pre-populated with the booking number.

If a clerk enters a pre-advised container number, then N4 automatically fills in the Booking/Order field with the pre-advised order number.

For a Deliver Empty (DM) gate transaction, if a default EDO is specified for a trucking company, the default EDO will pre-populate in the Booking/Order field when a clerk selects the trucking company in the Trucking Company ID field. Both fields must be displayed on the gate form. For more information on setting a default EDO for a trucking company, see Trucking Company form (on page 1).

Notes

 

Bundle - Add/Edit

Displays a button in a gate form that enables the clerk to record bundled unit numbers.

When a clerk selects the button, the Bundle form (on page 1) will open for the clerk to enter the bundled details.

When you include the Bundle - Add/Edit field at the ingate stage, N4 retains the bundle information for the unit through all subsequent stages for the gate transaction type. If you want to make the field viewable at subsequent gate stages, you can include the Bundle - Add/Edit field as a view-only field at the other stages.

Units previously bundled in the system are not pre-populated in a gate form, therefore any existing bundled units at the gate must be entered in the gate form.

 

Category

For a receival gate transaction, displays a drop-down list for the clerk to select a container category of Export or Domestic in a gate form.

The field is pre-populated with the booking, rail order, or pre-advised category when a clerk,

For non-booking gates, the Category field is required in the Receive Export (RE) gate transaction form to receive domestic containers. To deliver domestic containers, the Category field is required in the Deliver Import (DI) gate transaction form.

 

Chassis Accessory Damages - Add

Displays a button in a gate form that enables the clerk to record chassis accessory damages.

When a clerk selects the button the Damages form (on page 1) will open for the clerk to enter the chassis accessory damage details.

For a delivery gate transaction, N4 automatically fills in any damages associated with the chassis accessory. However, for a receive gate transaction, N4 only fills in damages from the inspections and does not automatically associate any damages previously recorded for the chassis accessory.

If you want the chassis accessory damages to be saved with the unit, you must include the Chassis Accessory Damages - Add field for all the subsequent stages for the gate transaction type. However, if you do not want the user to add or edit the information at a later stage, you can include the Chassis Accessory Damages - Add field as a view-only field at that stage.

For example, if you include the Chassis Accessory Damages - Add field at the ingate stage, you must include the Chassis Accessory Damages - Add field at any intermediate gate stage and the outgate stage for N4 to save the chassis accessory damages with the unit.

 

Chassis Accessory Number

Displays a text field for the clerk to enter the chassis accessory number in a gate form.

The system will prompt you to re-enter an unknown chassis accessory number.

 

Chassis Accessory Operator

Displays a lookup field of line operators in a gate form for the clerk to select the equipment operator of the chassis accessory.

 

Chassis Accessory Owner

Displays a lookup field of the line operators for the clerk to select the owner of the chassis accessory in a gate form.

 

Chassis Accessory Owner ID

Displays a text field for the clerk to enter the line operator that owns the chassis accessory in a gate form.

 

Chassis Accessory Tare

Displays a text field for the clerk to enter the weight of the chassis accessory, in kilograms. In your Gate form, when you enter a known container accessory number (existing in the Accessories view), N4 auto populates the Chassis Accessory Tare weight from the Accessories table. If you are entering a chassis accessory number that does not exist in the Accessories view, N4 populates the chassis accessory tare weight available under the Equipment Types view.

To enter weight using a specific unit:

 

 

Chassis Accessory Type

Displays a drop-down list of chassis accessory ISO types in a gate form.

 

Chassis Damaged

Displays a check box in a gate form for the clerk to indicate if the chassis is damaged and requires an inspection at another gate stage.

When a clerk checks this field and successfully saves the gate transaction, this field will pre-populate as checked if displayed in a gate form at a subsequent gate stage.

This information is saved only on the gate transaction record, it is not saved on the chassis record. Do not use this field in edit mode with the Chassis Damages - Add field at the same gate stage.

 

Chassis Damages - Add

Displays a button in a gate form that enables the clerk to record chassis damages.

When a clerk selects the button the Damages form (on page 1) will open for the clerk to enter the chassis damage details.

For a delivery gate transaction, N4 automatically fills in any damages associated with the chassis. However, for a receive gate transaction, N4 only fills in damages from the inspections and does not automatically associate any damages previously recorded for the chassis.

If you want the chassis damages to be saved with the unit, you must include the Chassis Damages - Add field for all the subsequent stages for the gate transaction type. However, if you do not want the user to add or edit the information at a later stage, you can include the Chassis Damages - Add field as a view-only field at that stage.

For example, if you include the Chassis Damages - Add field at the ingate stage, you must include the Chassis Damages - Add field at any intermediate gate stage and the outgate stage for N4 to save the chassis damages with the unit.

 

Chassis IsOwners

Displays a check box in a gate form for the clerk to indicate if the trucking company is the owner of the chassis. If this field is checked in an in-gate form, then upon entry of a new chassis in the Chassis Number field N4 will not ask for double blind entry. In addition, N4 does not create new chassis equipment marked as own.

 

Chassis License

Displays a text field for the clerk to enter the chassis license number in a gate form.

 

Chassis Number

Displays a text field for the clerk to enter the chassis number in a gate form. Use this field at the ingate for a receive gate transaction type, and at the outgate for a deliver transaction type.

N4 prompts you to re-enter an unknown chassis number.

For a Receive Chassis (RC) gate transaction, when a clerk enters an existing bare chassis number, N4 automatically fills in any existing chassis data in the following fields,

Use the Chassis Number Requested field at the ingate for a deliver gate transaction.

 

Chassis Number Requested

Displays a text field for the clerk to enter the chassis number requested by the driver at the ingate for a deliver gate transaction type.

 

Chassis Operator

Displays a lookup field of line operators for the clerk to select the equipment operator for the chassis received at the ingate.

 

Chassis Owner

Displays a lookup field of line operators for the clerk to select the owner of the chassis in a gate form.

 

Chassis Owner ID

Displays a text field for the clerk to enter the line operator that owns the chassis in a gate form.

This is a free form text field that should only be used if there are no business validations for the chassis owner.

 

Chassis Safe Weight

Displays a text field for the clerk to enter the maximum weight that can be safely carried by the chassis, in kilograms.

To enter weight using a specific unit:

 

Chassis Tare

Displays a text field for the clerk to enter the weight of the bare chassis being received at the ingate, in kilograms.

To enter weight using a specific unit:

 

Chassis Type

Displays a lookup field of chassis types for the clerk to select from in the gate form. When you type in the Chassis Type or select from the dropdown, the tare weight and safe weights of chassis, from the chassis master record, are populated if those fields are configured on the gate form.

This is a required field if you are trying to create a chassis unit as part of the gate transaction. You can include it as a "hidden" field on the gate forms for the subsequent gate stages to ensure that the value selected during the initial stage is persisted for the gate transaction.

 

Commodity

Displays a lookup field of the commodity codes in a gate form.

For a Receive Export (RE) or Deliver Empty (DM) gate transaction the field is pre-populated with the commodity code specified on an equipment order item or a container pre-advise when a clerk,

 

Commodity Description

Displays a text field for the clerk to enter or edit the commodity code descriptions in a gate form.

The field pre-populates with the existing commodity description when a clerk selects a Commodity, or when the Commodity field is pre-populated with a commodity code, if this field is also displayed in the gate form.

 

Consignee

Displays a lookup field of consignees for the clerk to select from in the gate form. If the consignee doesn't exist, the clerk can enter a new consignee and the new consignee is created in N4.

The ARGOSHIPPERCONSIGNEE001 (SHIPPER_CONSIGNEE_USING_NAME) (on page 1) setting determines if N4 displays consignee IDs or consignee names in the list of values for this field.

N4 automatically fills in the consignee from an equipment order when a clerk,

 

Container Accessory Damages - Add/Edit

Displays a button in a gate form that enables the clerk to record container accessory damages.

When a clerk selects the button the Damages form (on page 1) will open for the clerk to enter the container accessory damage details.

For a delivery gate transaction, N4 automatically fills in any damages associated with the container accessory. However, for a receive gate transaction, N4 only fills in damages from the inspections and does not automatically associate any damages previously recorded for the container accessory.

If you want the container accessory damages to be saved with the unit, you must include the Container Accessory Damages - Add field for all the subsequent stages for the gate transaction type. However, if you do not want the user to add or edit the information at a later stage, you can include the Container Accessory Damages - Add field as a view-only field at that stage.

For example, if you include the Container Accessory Damages - Add field at the ingate stage, you must include the Container Accessory Damages - Add field at any intermediate gate stage and the outgate stage for N4 to save the container accessory damages with the unit.

 

Container Accessory Nbr

Displays a text field for the clerk to enter the container accessory number in a gate form.

The system will prompt you to re-enter an unknown container accessory number.

 

Container Accessory Operator

Displays a lookup field of the line operators for the clerk to select the equipment operator for the container accessory received at the ingate.

 

Container Accessory Owner

Displays a lookup field of line operators in a gate form for the clerk to select the owner of the container accessory.

 

Container Accessory Owner ID

Displays a text field for the clerk to enter the line operator that owns the container accessory.

 

Container Accessory Tare

Displays a text field for the clerk to enter the weight of the container accessory, in kilograms. In your Gate form, when you enter a known container accessory number (existing in the Accessories view), N4 auto populates the Container Accessory Tare weight from the Accessories table. If you are entering a container accessory number that does not exist in the Accessories view, N4 populates the container accessory tare weight available under the Equipment Types view.

To enter weight using a specific unit:

 

Container Accessory Type

Displays a drop-down list of container accessory ISO types in a gate form.

 

Container Build Date

Displays a text field to enter the date when the equipment being received at the gate was built. The Build Date is also displayed in the corresponding equipment form, such as the Container form for a container or the Chassis form for a chassis.

N4 does not perform any validations for this field. However, if you include the ApplyPhysicalDetails (on page 1) or the CreateNewContainer (on page 1) business tasks in your gate configuration, the business tasks set this field for the unit specified in the gate transaction.

 

Container Condition

Displays a text field for the clerk to enter or edit the condition of the container.

 

Container Damages - Add/Edit

Displays a button in a gate form that enables the clerk to record container damages. When a clerk selects the button the Damages form (on page 1) will open for the clerk to enter the container damage details.

If you want the container damages to be saved with the unit, you must include the Container Damages - Add field for all the subsequent stages for the gate transaction type. However, if you do not want the user to add or edit the information at a later stage, you can include the Container Damages - Add field as a view-only field at that stage.

For example, if you include the Container Damages - Add field at the ingate stage, you must include the Container Damages - Add field at any intermediate gate stage and the outgate stage for N4 to save the container damages with the unit.

When a clerk records damages and saves a transaction, N4 records the UNIT_DAMAGED event against the unit. However, if a clerk edits existing damages and:

Notes

 

Container is Sealed

Displays a check box in a gate form for a clerk to select if a container is sealed. You can use this field to indicate that a container is sealed without having to record the seal numbers.

If you want to save this information on the unit, you must include the ApplyContainerSeals (on page 1) or CreateContainerVisit (on page 1) business task at the same gate stage.

N4 does not automatically select the Container is Sealed check box when seals are recorded. The Container is Sealed check box is designed to be set by a user or gate API for customers who do not want to record seal numbers.

 

Container Nbr

Displays a text field for the clerk to enter the container number in a gate form. Use this field at the ingate for a receive gate transaction type, and at the outgate for deliver gate transaction type. 

N4 prompts you to re-enter an unknown container number.

When entering a container number with an existing master record in N4:

Use the Container Nbr Requested field at the ingate for a deliver gate transaction. For more information, see How do I configure the various container number fields in a gate configuration (on page 1) in the Navis N4: Gate Administrator and User Guide .

Pre-populated fields

If a clerk enters a Container Nbr in the Pre-Selection area on the <GateStage> tab, this Container Nbr field is pre-populated with the container number.

If the container is pre-advised but the routing information for the booking in N4 was updated after the container pre-advise, then N4 automatically fills in the latest routing data for the above fields from the booking instead of using the existing pre-advise routing data.

When a clerk enters an existing container number, the existing container data will pre-populate in the following fields,

If the container is an import or pre-advised export container, then in addition to the above fields, N4 automatically fills in the existing container data in the following fields if these fields are displayed in the gate form:

 

Container Nbr provided

Displays a text field with the container number provided to the driver in the yard for a deliver gate transaction type.

XPS provides the container number to N4 after putting the container on a truck, then N4 automatically fills in the Container Nbr provided field in the <GateStage> tab for all gate stages after the yard.

To copy the value in the Container Nbr provided field to the Container Nbr field, include the CopyContainerProvidedToNbr (on page 1) business task.

For more information, see How do I configure the various container number fields in a gate configuration (on page 1) in the Navis N4: Gate Administrator and User Guide.

 

Container Nbr Requested

Displays a text field for the clerk to enter the container number requested by the driver at the ingate for a deliver gate transaction type.

If a clerk enters a Container Nbr in the Pre-Selection area on the <GateStage> tab, the Container Nbr Requested field is pre-populated with the container number.

If you do not have an outgate stage for deliver gate transactions, use this field at the ingate and the CopyContainerAssignedToNbr (on page 1) business task.

Also see Container Nbr and How do I configure the various container number fields in a gate configuration (on page 1) in the Navis N4: Gate Administrator and User Guide.

 

 

Container Operator

Displays a lookup field of the line operators for the clerk to select the equipment operator for the container received at the ingate.

The field is pre-populated with the container or booking line operator when the clerk,

 

Container Owner

Displays a lookup field of the line operators for the clerk to select the owner of the container in a gate form.

 

Container Owner ID

Displays a text field for the clerk to enter the line operator that owns the container in a gate form.

This is a free form text field that should only be used if there are no business validations for the container owner.

 

Container Rail Configuration

Displays a drop down list for you to select Top, Bottom, Both, or None options to specify the presence of rail on a tank container. N4 populates the value for the Container Rail Configuration field when creating a container for XPS through the CreateNewContainer business task.

N4 prints the container rail configuration value on the gate tickets.

 

Container Safe Weight

Displays a text field for the clerk to enter the maximum allowed weight of the container, including cargo in kilograms.

To enter weight using a specific unit:

 

Container Tare

Displays a text field for the clerk to enter the weight of the container, without cargo in kilograms.

The field is pre-populated with the container tare weight when a clerk enters an existing Container Number or the Container Type for a new container. However, if a container tare weight is entered during an inspection, then N4 overwrites any existing values with the inspection tare weight value.

To enter weight using a specific unit:

 

Container Type

Displays a lookup field of ISO types for the clerk to select the container ISO type in the gate form.

The field is pre-populated with the container ISO type when a clerk enters an existing Container Number.

For a Receive Export (RE) gate transaction, when a clerk selects the Container Type, and selects the Booking or enters an existing Booking Number, the existing equipment order item data will pre-populate in the following fields,

If these fields are also displayed on the gate form.

 

CSC Expiration

Displays a text field for the clerk to enter the container's CSC expiration date. Expected values are NONE, ACEP, or a date using the MMYY format.

 

Custom Transaction Action

Displays the Custom Transaction Action button in the Transaction Entry area of the gate form. The gate clerk can use this to execute a Groovy code extension of type, GATE_UI_FIELD_INTERCEPTOR, configured for your site. For more information, see Groovy Interception at the Gate Transaction Level in the Navis N4: Customization Administrator Guide or the online help.

By default, N4 displays the label of the button as Custom Transaction Action. You can use the Administration Settings Resource Bundles Resource Bundles view to add a resource bundle and override the CUSTOM_TRANSACTION_ACTION property key to define a custom label that describes the action that the Groovy plug-in performs. The CUSTOM_TRANSACTION_ACTION property key is defined in the RoadPropertyKeys.java.

For example, if the Groovy code extension reads the scale weight and updates the Scale Weight field (on page 1) in the Transaction Details area, you can label the Custom Action button as Update Scale Weight.

 

Damaged

Displays a check box in a gate form for the clerk to indicate if the container is damaged and requires an inspection at another gate stage.

When a clerk checks this field and successfully saves the gate transaction, this field will pre-populate as checked if displayed in a gate form at a subsequent gate stage.

This information is saved only on the gate transaction record, it is not saved on the container record. Do not use this field in edit mode with the Container Damages - Add field at the same gate stage.

 

Destination

Displays a text field for a clerk to enter the final destination of the container in a gate form.

 

Discharge Port

Displays a lookup field of discharge ports for the clerk to select the first port of discharge for the export container in a gate form.

The field is pre-populated with the booking or pre-advised port of discharge when a clerk,

 

Discharge Port 2

Displays a lookup field of discharge ports for the clerk to select the second port of discharge for the export container in a gate form.

The field is pre-populated with the booking or pre-advised second port of discharge when a clerk,

 

Discharge Port 3

Displays a lookup field of discharge ports for the clerk to select the third port of discharge for the export container in a gate form.

This field does not pre-populate with the third port of discharge on a booking or pre-advised container.

 

Door Direction

Displays a drop-down list for the clerk to select the direction of the doors on a container. This field should be used for XPS operations only.

 

Exchange Area Id

Displays a text field for the clerk to enter the exchange area ID for the gate transaction.

When you specify the Exchange Area, N4 filters the Exchange Lane drop-down field to display only the exchange lanes associated with the selected exchange area.

 

Export Release Nbr

Displays a text field for a clerk to enter the export release number required for a deliver gate transaction such as a dray off, or to deliver an empty container against a booking.

The export release number can be a booking or a group number.

If the Release Number field is included in the Pre-Selection area on the <GateStage> tab and the clerk enters an existing booking or group number in the field, N4 automatically fills in the Export Release Number field with the same booking or group number.

See also RejectCtrNotFoundForGroupOrBL (on page 1)and RejectContainerSubstitutionNotMatchingGroupOrBL (on page 1).

 

Feature

Displays a lookup field of equipment features for the clerk to select the requested equipment feature for a container for a deliver transaction type.

For a Receive Export (RE) or Deliver Empty (DM) gate transaction the field is pre-populated with the booking equipment feature when a clerk,

 

Freight Kind

Displays a drop-down list of freight kinds for the clerk to select the container freight kind in a gate form for a receive gate transaction type.

The field is pre-populated with the booking or pre-advised freight kind when a clerk,

N4 will not pre-populate the freight kind if a clerk enters a container created from a RELEASE EDI message that has not been pre-advised yet.

 

Grade

Displays a lookup field of the equipment grades for a clerk to select the requested equipment grade for a container for a deliver gate transaction type.

For a Receive Export (RE) or Deliver Empty (DM) gate transaction the field is pre-populated with the booking equipment grade when a clerk,

 

Gross Wt.

Displays a text field for a clerk to enter the weight of the container including its cargo, in kilograms.

For a Receive Export (RE) or Dray In (RI) gate transaction the field is pre-populated with the:

N4 calculates the gross weight as the scale weight minus the truck tare weight and any chassis or accessory tare weights. The clerk can update, or correct, the calculated gross weight in the Gross Weight field.

To enter weight using a specific unit:

 

Has Documents

Displays a check box that the gate clerk can select to indicate that the Driver has documentation to be processed. The gate clerk can use this field to indicate whether the driver has or does not have export documentation which can then be used to reject a gate transaction or conditionally send the driver to a different gate stage.

 

Hazard Checked

Displays a check box in the gate form for the clerk to indicate if the container's hazardous goods have been manually checked.

You must include the RejectCtrHazardsNotChecked (on page 1) business task to reject a gate transaction if the gate clerk does not select the check box for a hazardous container.

 

Hazardous

Displays a check box in a gate form for the clerk to indicate if the container is hazardous and requires an inspection at another gate stage.

When a clerk checks this field and successfully saves the gate transaction, this field will pre-populate as checked if displayed in a gate form at a subsequent gate stage.

This information is saved only on the gate transaction record, it is not saved on the unit. Do not use this field in edit mode with the Hazards - Add/Edit field at the same gate stage. In addition, N4 does not automatically select this check box when a container is pre-advised as hazardous. To see existing hazards, use the Hazards - Add/Edit field instead.

 

Hazards - Add/Edit

Displays a button in a gate form that enables the clerk to record new hazardous information for a container or edit existing hazardous information.

When a clerk selects the button the Hazards form (on page 1) will open for the clerk to edit or add the hazardous details.

If you want the container hazards to be saved with the gate transaction, you must include the Hazards - Add/Edit field for all the subsequent stages for the gate transaction type. However, if you do not want the user to add or edit the information at a later stage, you can include the Hazards - Add/Edit field as a view-only field at that stage.

For example, if you include the Hazards - Add/Edit field at the ingate stage, you must include the Hazards - Add/Edit field at any intermediate gate stage and the outgate stage for N4 to save the container hazards with the unit.

See also, MergeOrderHazards (on page 1).

Pre-populated fields

The field is pre-populated with the booking or pre-advised hazardous details when a clerk,

Notes

 

Import Delivery Order

Displays a text field for the clerk to enter the import delivery number for a Deliver Import (DI) gate transaction type.

If you use the SelectImportContainer (on page 1) business task, XPS will select the best available import container in the yard based on the value entered in the Import Deliver Order field.

 

Import Release Nbr

Displays a text field for the clerk to enter the import container release number for a Deliver Import (DI) gate transaction type. The data entered in this field can be any of the following:

If the Release Number field is included in the Pre-Selection area on the <GateStage> tab and the clerk enters an existing bill of lading or group number in the field, N4 automatically fills in the Import Release Nbr field with the same bill of lading or group number.

If you use the SelectImportContainer (on page 1) business task, XPS will select the best available import container in the yard based on the value entered in the Import Release Nbr field.

See also RejectCtrNotFoundForGroupOrBL (on page 1)and RejectContainerSubstitutionNotMatchingGroupOrBL (on page 1).

If you use the Bill of Lading functionality in N4 (INVBL001 (TRUE_BILLS_OF_LADING) is true for your site), the ReadReleaseNbr business task uses the Import Release Nbr from the gate transaction for an import container and sets the value for the transaction BL Number (tranBlNbr).

If you do not use the Bill of Lading functionality in N4 (INVBL001 (TRUE_BILLS_OF_LADING) is false for your site), you can use a GATE_TASK_INTERCEPTOR type code extension and use it to customize the SelectImportContainer (on page 1) business task to copy the Import Release Number to the transaction BL Number (tranBlNbr).

 

Is Confirmed

Displays a check box for the truck driver to confirm the gate transaction.

 

Is I/B to O/B Move Direct

Include this field in the Receive Export in-gate to enable rail direct delivery in-gate transactions. To use this field, you must add the business task PlanUnitIntoYardOrRailcar (on page 1) to your in-gate transaction..

When  "Is I/B to O/B Move Direct"  Is checked, the gated-in container will be directly planned to a railcar from the truck.

When "Is I/B to O/B Move Direct" is unchecked, the PlanUnitIntoYardOrRailcar (on page 1) will call the PlanUnitIntoYard (on page 1) business task to create a yard plan.

If the outbound carrier is train, N4 automatically checks this field. The gate clerk can override this flag as needed.

Note: For this field to work properly, ARGOBENTO011 must be set to N4.

 

 

Is Placarded

Displays a check box in a gate form for the clerk to indicate if the container has placards.

This information is saved only on the gate transaction record, it is not saved on the unit.

 

Line ID

Displays a lookup field of the line operators for the clerk to select the booking or container line operator in a gate form.

The field is pre-populated with the line operator ID when a clerk,

When you enter the container number in the Container Nbr field and tab out in the gate form, N4 populates the container line operator in the Line Id field. If you select the booking/order value in the Booking/Order field and tab out in the gate form, N4 populates the booking line operator in the Line Id field.

If the Line ID field contains a value, then N4 does not pre-populate the field overwriting the existing value.

 

Load Port

Displays a lookup field of load ports for the clerk to select for an export container in a gate form.

The field is pre-populated with the booking or pre-advised load port when a clerk,

 

M&R Status of Container

Displays a lookup field of container M&R codes.

 

Material

Displays a lookup field of container materials in a gate form.

If you do not want a user to edit the field, set the field as view-only. However, if you set the field as hidden, N4 does not update the unit with the material specified at the gate.

 

Military Transaction

Displays a text field for the clerk to enter the military transaction number required when exporting military cargo in the US.

This information is saved only on the gate transaction record, it is not saved on the unit.

 

Military V Number

Displays a text field for the clerk to enter the military V number required when exporting military cargo in the US.

This information is saved only on the gate transaction record, it is not saved on the unit.

 

Net Weight

Displays a text field for the clerk to enter the weight of the cargo, not including the weight of the container, in kilograms.

When a clerk specifies the net weight and successfully saves the gate transaction, N4 will calculate the container gross weight as the specified net weight plus the container tare weight.

To enter weight using a specific unit:

 

Notes

Displays a text field for the clerk to enter a short note about the container. If the gate transaction saves successfully, notes entered in this field will display on the unit inspector routing details page.

 

OOG

Displays a check box in a gate form for the clerk to indicate if the container is out of gauge and requires inspection at another gate stage. This information is saved only on the gate transaction record, it is not saved on the unit.

When a clerk checks this field and successfully saves the gate transaction, N4 displays this field as selected at any subsequent gate stage where it is included in the gate form.

Do not use this field with the OOG - Add/Edit field (on page 1) at the same gate stage. If you add the OOG details in the OOG - Add/Edit form (on page 1), N4 does not select the OOG check box, automatically.

 

OOG - Add/Edit

Displays a button in a gate form that enables the clerk to review, edit, or record out of gauge measurements for a container.

When a clerk clicks the button, N4 displays the OOG - Add/Edit form (on page 1) for the clerk to edit or add the OOG details.

If the clerk enters a pre-advised Container Number, N4 fills in the OOG details in the OOG - Add/Edit form, automatically.

If you want the OOG details to be saved with the unit, you must include the OOG - Add/Edit field for all the subsequent stages for the gate transaction type. However, if you do not want the user to add or edit the information at a later stage, you can include the OOG - Add/Edit field as a view-only field at that stage.

For example, if you include the OOG - Add/Edit field at the ingate stage, you must include the OOG - Add/Edit field at any intermediate gate stage and the outgate stage for N4 to save the OOG details with the unit.

Notes

 

Optional POD

Displays a lookup field of discharge ports for the clerk to select the optional port of discharge for the container, if any.

 

Origin

Displays a text field for the clerk to enter the origin of the container in a gate form.

 

Pin Number

Displays a text field for you to enter the PIN or Release Number for a container or break-bulk cargo unit at the appointment stage or gate stage.

If both the delivery order and the bill of lading are specified for the break-bulk cargo, N4 first matches the specified PIN to the Deliver Order PIN. If only the bill of lading is specified, N4 matches the specified PIN to the bill of lading PIN.

You can also include this field in the create-appointment gate API.

If the PIN is entered at the appointment stage or sent in the create-appointment API, N4 does not save the PIN against the appointment. It uses the PIN to only execute the three business tasks related to the PIN, RejectPinNbrMismatch (on page 1), RejectPinNbrNotAssigned (on page 1), RejectPinNbrNotEntered (on page 1).

 

Placards - Add/Edit

Displays a button in a gate form that enables the clerk to review/edit or record placards for the hazards associated with a gate transaction.

When a user clicks the Add/Edit Placards button, N4 displays the Placards - Add/Edit form where the user can enter the placard details.

 

Pos on Truck

Displays a text field for the position of the container on a truck. N4 supports positions 1 to 11. For more information, see Supported truck positions (on page 1).

If you use the SequenceTransactions (on page 1) business task, the position helps to determine the order in which the containers are to be lifted from the truck, or placed on the truck, by XPS.

This field should be used for XPS operations only.

 

Reefer - Add/Edit

Displays a button in a gate form that enables the clerk to review/edit or record reefer information for a container.

If you include the Reefer - Add/Edit button in a gate form, do not include the Temperature Setting field in the same gate form.

When a clerk selects the button the Reefer - Add/Edit form (on page 1) will open for the clerk to edit or add the reefer details.

For a Receive Export (RE) gate transaction the field is pre-populated with the booking item or pre-advised container reefer details when a clerk,

If you want the reefer details to be saved with the unit, you must include the Reefer - Add/Edit field for all the subsequent stages for the gate transaction type. However, if you do not want the user to add or edit the information at a later stage, you can include the Reefer - Add/Edit field as a view-only field at that stage.

For example, if you include the Reefer - Add/Edit field at the ingate stage, you must include the Reefer - Add/Edit field at any intermediate gate stage and the outgate stage for N4 to save the reefer details with the unit.

If existing reefer information is pre-populated in this field the button will be labeled as Edit Reefer, instead of Add Reefer, in the gate form.

 

Scale Weight

Displays a text field for the clerk to enter the scale weight or the total weight of the truck, chassis, any containers, cargo, and accessories, in kilograms.

To enter weight using a specific unit:

 

Seal #1

Displays a text field for the clerk to enter the first seal number of the container.

 

Seal #2

Displays a text field for the clerk to enter the second seal number of the container.

 

Seal #3

Displays a text field for the clerk to enter the third seal number of the container.

 

Seal #4

Displays a text field for the clerk to enter the fourth seal number of the container.

 

Shipper

Displays a lookup field of shippers for the clerk to select from in the gate form. If the shipper doesn't exist, the clerk can enter a new shipper and the new shipper is created in N4.

The ARGOSHIPPERCONSIGNEE001 (SHIPPER_CONSIGNEE_USING_NAME) (on page 1) setting determines if N4 displays shipper IDs or shipper names in the list of values for this field.

N4 automatically fills in the consignee from an equipment order when a clerk,

 

Shipper/Consignee Agent

Displays a text field for the clerk to enter the agent used by the shipper or the consignee.

 

Special Stow

Displays a drop-down list of special stow codes for the clerk to select the special stow requirements for an export container.

 

Temperature Setting

Displays a text field for the clerk to enter the booked required temperature for a reefer container.

If you include the Temperature Setting field in a gate form, do not include the Reefer - Add/Edit button in the same gate form.

 

To Slot

Displays a text field for the clerk to enter the slot position in the yard to place the incoming container received through the gate. This field should be used when using the PlaceUnitIntoYard (on page 1) business task.

N4 automatically fills in the To Slot field with the planned position by default. If the To Slot field is blank, then N4 places the container in a position of Yard with no slot.

 

Truck Safe Weight

Displays a text field for the clerk to enter the maximum allowed weight of the truck including chassis and cargo in kilograms.

To enter weight using a specific unit:

 

Truck Tare

Displays a text field for the clerk to enter the weight of the truck and chassis without cargo in kilograms.

To enter weight using a specific unit:

 

 

Trucking Co Id (Truck Transaction)

Displays a text field for the user to enter a trucking company ID in a gate form at the gate transaction type level.

For example, if you have a scenario where a truck driver is associated with multiple trucking companies and you need to process multiple gate transactions for the same truck visit for different trucking companies, you can use this field at the gate transaction level to associate a different trucking company with each gate transaction.

See also, Trucking Co. (on page 1)

 

Trucking Co.

Displays a lookup field of trucking company IDs in a gate form.

The field will pre-populate with the trucking company ID selected on the truck visit form for the clerk to edit if desired.

See also, Trucking Co Id (Truck Transaction) (on page 1).

 

Unit Id

Displays a text field for the clerk to enter a unique ID for the cargo being received as part of a Receive Break-Bulk (RB) gate transaction type.

When the gate clerk specifies a Unit Id, N4 manifests an identified cargo lot.

 

Vessel Visit

Displays a drop-down list of the vessel visits for a clerk to select for the export container.

The field is pre-populated with the booking or pre-advised vessel visit when a clerk,

You can use the VESLVVFM003 (ACTIVE_VISIT_FORWARD_VIEW_DAYS) configuration setting to restrict the number of vessel visits by their estimated time of arrival (ETA) date. If you do not restrict the number of vessel visits, N4 displays a maximum of 1000 records in the Vessel Visit lookup field.

 

VGM Verifier

Displays a text field for the gate clerk to enter the business party, such as the shipper or the terminal, that provided the most recent update to the Verified Gross Mass (VGM) of the container.

When you enter a value for this field as part of a gate transaction, N4 updates the same for the unit associated with the gate transaction when you save the gate transaction, successfully.

You can also view this field in the Gate Transactions view (on page 1) under the 03-Container group. The column is not displayed by default.

 

VGM Weight

Displays a text field for a gate clerk to enter the Verified Gross Weight (VGM) for the container. The default unit for the field is kg. You must include this field on a gate form for a gate transaction type, if you have included the RejectVGMWeightRequired (on page 1) business task for the same gate transaction type in your gate configuration.

When you enter a value for this field as part of a gate transaction, N4 updates the same for the unit associated with the gate transaction when you save the gate transaction, successfully. You can also view this field in the Gate Transactions view (on page 1) under the 03-Container group. The column is not displayed by default.

For more information about VGM, see Track VGM (verified gross weight).

 

View Bills Of Lading

Prerequisites

Displays the View Bill Of Lading button in a gate form to enable a gate clerk to view the bills of lading associated with a unit. Use this field for Deliver Import (DI) and Dray In (RI) gate transaction types.

The View Bill Of Lading button, by default, appears disabled in a gate form. To enable this button, at an ingate stage, enter a container number that has associated bill(s) of lading in either the:

When the View Bill Of Lading button is enabled, selecting it opens the Bill Of Lading form (on page 1) that displays the bills of lading associated with the unit.

You can print all of the associated bill of lading numbers in a gate document with the argo:tranUnitBls tag.

 

Xray Required

Displays a check box in the gate form to indicate that the container needs to be x-rayed.